package cbfg.http.annotation

/**
 * Denotes that the request body will use form URL encoding. Fields should be declared as
 * parameters and annotated with [@Field][Field].
 *
 * Requests made with this annotation will have `application/x-www-form-urlencoded` MIME
 * type. Field names and values will be UTF-8 encoded before being URI-encoded in accordance to
 * [RFC-3986](http://tools.ietf.org/html/rfc3986).
 */
@MustBeDocumented
@Target(
    AnnotationTarget.FUNCTION,
    AnnotationTarget.PROPERTY_GETTER,
    AnnotationTarget.PROPERTY_SETTER
)
@kotlin.annotation.Retention(AnnotationRetention.RUNTIME)
annotation class FormUrlEncoded